LGF_DTLToString_ISO (FC / 3.1.1)

Übersicht

Autor: Siemens Digital Industry

Kurzbeschreibung

Diese Funktion konvertiert ein Datum vom Datentyp DTL in eine Zeichenkette vom Datentyp STRING im internationalen Format (ISO) (YYYY MM DD ...).

Baustein Schnittstelle

LGF_DTLToString_ISO (FC)
DTL  date Ret_Val  String
    
Char  separator   
    
Char  separatorDateAndTime   
    
   

Input Parameter

BezeichnerDatentyp Beschreibung
dateDTL Datum zum Konvertieren im Format DTL
separatorChar Trennzeichen zwischen den Komponenten des ausgegebenen Datums.
separatorDateAndTimeChar Trennzeichen zwischen den Komponenten Datums und Zeit.

Output Parameter

BezeichnerDatentyp Beschreibung
Ret_ValString Ausgegebenen Zeichenkette entsprechend dem internationalen Format (ISO 8601).
Beispiel: `2019-01-22 14:06:51.524621000`

Funktionsbeschreibung

Der Baustein liest ein Datum vom Datentyp DTL ein und konvertiert die einzelnen Komponenten des Datums (Jahr, Monat, Tag, Stunde...) in eine Zeichenkette und gibt diese im internationalen Format (ISO 8601) aus. Das Trennzeichen zwischen den Komponenten des Datums ist variabel.

Internationales Format (ISO 8601):

LGF_DTLtoString_ISO - Aufbau der Zeichenkette nach ISO 8601

Trennzeichen:

Am Eingangsparameter separator geben Sie das Trennzeichen zwischen den Komponenten des Datums an, bei seperatorDateAndTime geben Sie das Trennzeichen zwischen Datum und Uhrzeit an.

Beispiel:

Änderungshistorie

Version & DatumÄnderungsbeschreibung
1.0.0Siemens Industry Online Support
15.06.2016First released version
1.0.1Siemens Industry Online Support
02.01.2017Upgrade: TIA Portal V14 Update 1
1.0.2Siemens Industry Online Support
17.08.2018Upgrade: TIA V15 Update 2
1.0.3Siemens Industry Online Support
23.11.2018Upgrade: TIA V15.1
1.0.4Simatic Systems Support
17.07.2019Bugfix - nanosecond precision and '0' filling
1.0.5Simatic Systems Support
18.07.2019Renamed from "LGF_DTLtoString" to "LGF_DTLToString_ISO"
Split into two blocks, removed "format" input
3.0.0Simatic Systems Support
23.04.2020Set version to V3.0.0
Harmonize the version of the whole library
3.0.1Simatic Systems Support
23.02.2021Insert documentation
3.1.0Simatic Systems Support
25.07.2025Insert parameter for separator between Data and time
Assign default value '-' for separator parameter
3.1.1Simatic Systems Support
09.10.2025Spelling errors